home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / os2 / snpdmp.arj / READ.ME < prev    next >
Text File  |  1994-03-02  |  5KB  |  127 lines
  1. AVAILABLILITY of IBM SNAPDUMP for OS/2
  2.       A tool FREE to All
  3.  
  4.  
  5. DESCRIPTION:
  6.     The SnapDump and the SnapDump Formatter are tools for software
  7. defect support on OS/2 product.  They provide the ability
  8. to easily capture a wide variety of data and data types into a
  9. single file and display this data in a formatted, user friendly
  10. fashion.
  11.  
  12. INSTALLING SNAPDUMP:
  13.     Use SnapDump/2 from this Diskette or
  14.     install with either method:
  15.       Create a directory for SNAPDUMP (e.g. 'mkdir SNAPDUMP).
  16.       Copy this diskette into the directory just created and
  17.       execute from this directory.
  18.     Or
  19.       Copy the diskette into the directory 'OS2\SYSTEM'.
  20.       This will allow  execute of SNAPDUMP must every where.
  21.  
  22.  
  23. HOW DOES SNAPDUMP WORK:
  24.    The SnapDump facility consists of a SnapDump Data Collector and
  25. a SnapDump Format Utility.
  26.  
  27. SnapDump Data Collector
  28.    The SnapDump Data Collector provides the ability to collect:
  29. *  Files (typically containing configuration and error data)
  30. *  Data Areas (that may contain key control blocks or buffers)
  31. It also has the ability to invoke programs that will aid in the
  32. collection  of system statistics and other system information.  In
  33. addition, SnapDump automatically gathers environment information and
  34. key system data areas and buffers (e.g. system trace buffer, process
  35. status, semaphore usage etc).  The SnapDump Data Collector utilizes
  36. a flat ASCII file as input.  This file contains the instructions
  37. that specify what data is to be collected (e.g. files, memory areas),
  38. or what data gathering program is to be invoked. This flat file
  39. approach makes the SnapDump Data Collector very flexible in that it
  40. can be easily tailored to add or remove items to be collected.
  41. CLI for SnapDump Data Collector:
  42.    The Command Line Interface (CLI) follows:
  43.  
  44.    'SNAPDUMP {input_flat_file output_captured_data}'
  45.  
  46. Both input_flat_file and output_captured_data are optional.
  47. input_flat_file defaults to SNAPDUMP.DAT.
  48. output_capture_data defaults to SNAPDUMP.DMP.
  49.  
  50. SnapDump Format Utility:
  51.    The SnapDump Format Utility provides an easy to use menu interface
  52. to select and display the contents of the SnapDump output file.
  53. Because all of the data items collected in the dump file are tagged
  54. with "entry titles", it is very easy to select a specific item of
  55. data for display, thus alleviating the need to display the entire
  56. dump file.  The PF12 key is used to toggle the data display between
  57. these formats hexadecimal and ASCII, hexadecimal EBCDIC and text.
  58. In addition, the SnapDump Format Utility allows for the
  59. ability to extract that piece of data and place it back into its
  60. native format. This is particularly useful for binary files that
  61. require specialized formatters. The binary file can be extracted
  62. from the dump file and placed back onto the DASD medium for use
  63. by the specialized format utility.
  64. CLI for SnapDump Format Utility:
  65.    The Command Line Interface (CLI) follows:
  66.  
  67.    'SNAPDF {output_captured_data}'
  68.  
  69. The output_captured_data parameter is optional; output will be displayed
  70. in the open dialog box by default.
  71.  
  72. DOCUMENT FILE
  73.    The documentation file is SNAPDUMP.DOC.  The file may be printed with
  74. 'print snapdump.doc'.
  75.  
  76. PROBLEM SOLVED WITH SNAPDUMP:
  77.    An end user having a software problem needs to be able to easily
  78. capture all the problem related information requested by support
  79. personnel.  This information is currently dispersed throughout the
  80. end user's system and presently requires a lot of work by the end
  81. user to locate and gather it all up to send to the support
  82. personnel.  The execution of SnapDump will capture file needed
  83. by the support team.
  84.    Example:
  85.    A customer's running IBM OS/2 ES Communications Manager changes
  86. the STARTUP.CMD to use a different configuration file.  The next day
  87. the customer starts the PS/2 and finds the Communications Manager is
  88. not running the same as the day before.  The customer, forgetting he
  89. had changed configuration files, calls level 2 support team.  Level 2
  90. support requests a list of 8 files in different directories which the
  91. customer needs to provide.  The customer now must find each file, then
  92. send this to the Level 2 support team.  With SnapDump the customer
  93. executes SnapDump, which collects all the files plus the configuration
  94. file from the day before.  The Level 2 support team is able to find
  95. the changes in the two configurations file then inform the customer.
  96. This is one of the ways SnapDump may help perform
  97. Problem Determination/Problem Source Identifier (PD/PSI).
  98.  
  99.  
  100. USAGE SUPPORT:
  101.   Usage support, for Customers  and SEs, will be provided through
  102. EQUAL/ASKQ.  Keyword for entries should be "SNAPDUMP".
  103.  
  104. DEFECT SUPPORT:
  105.   Defect support for SnapDump will be handled through SNAPDUMP FORUM
  106. on IBMPC which will be monitored.  Defect will be answered with in 2
  107. weeks.
  108.  
  109. SUPPORT PROGRAMS:
  110.   NETSESS2.EXE
  111.      Session statistical and status
  112.   NCBSTAT.EXE
  113.      Network control block information.
  114.   DIRSTAT.EXE
  115.      Adapter status information (SAPS, Link Stations, etc.)
  116.   QMC.EXE
  117.      Workstation hardware configuration.
  118.   FINDSEG.EXE
  119.      Environment loaded into the system.
  120.   TRADUMP.EXE
  121.      Adapter Shared Ram Dump if TRADUMP.SYS device driver was loaded
  122.   LAPSDUMP.EXE
  123.      Adapter Shared Ram Dump and Netbios Dump if TRADUMP.SYS device driver
  124.      was loaded.
  125.  
  126.  
  127.